home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / Codex ass dev system v1.10.adf / ReadMe < prev    next >
Text File  |  1988-09-19  |  8KB  |  174 lines
  1. ReadMe File
  2.  
  3.       zum CodeX Assembler Development System
  4.             von Stefan Riege, 1989,90
  5.  
  6.  
  7. Die Programmfertigstellung geschah nach dem Drucken des Handbuchs, so daß
  8. Änderungen in den Programmen nicht mehr mit aufgenommen werden konnten.
  9. Dieses File soll die Änderungen beschreiben, soweit dies nötig ist.
  10.  
  11. **************************HISTORY***********************************
  12. ---20.01.90, V1.10&DEBUGGER V1.35---
  13. Vielen Dank an Michael Cremer für das Auffinden einiger Fehler sowie
  14. vieler Verbesserungsvorschläge !!
  15.  
  16.  
  17. ZUM DEBUGGER
  18.  
  19.    RECORD BEFEHLE
  20.       Die Realisation der Record Befehle war weit komplizierter als zuerst
  21.       gedacht, daher müssen diese Befehle etwas abweichen, bzw. es sind
  22.       kleine Einschränkungen zu machen:
  23.       Nachdem der Record Mode eingeschaltet worden ist ("onr"), können zwar
  24.       gespeicherte Record Dateien geladen werden ("lr"), innerhalb dieser
  25.       Dateien wird jedoch der Befehl "offr" übergangen, da sonst nach jedem
  26.       Aufruf von Dateien das Recording abgeschaltet sein würde, da dieser
  27.       Befehl normalerweise am Ende einer Record Datei steht.
  28.       Weiterhin sollten die Record Befehle i.a. mit Vorsicht benutzt werden,
  29.       da z.B. das Ansprechen von Adressen über absolute Werte überhaupt
  30.       nicht möglich ist, oder auch Fehler, die während des Ladens auftreten
  31.       völlig übergangen werden.
  32.    TABULATOR
  33.       Der Übersicht wegen ist eine klare regelmäßige äußere Form des Source
  34.       wünschenswert. Um dies zu unterstützen, kann das Listing mit Shift und
  35.       der Tabulatortaste korrigiert werden. In einem solchen Fall wird der
  36.       Text bis zum nächsten Tabulator aufgerückt (am besten diese Funktion
  37.       ausprobieren). Da viele Editoren diese Funktion standardmäßig auf der
  38.       einfachen Shift Taste haben, können die Funktionen von Shift Tab und
  39.       Tab mit CTRL+QT getauscht werden (ein wiederholter Aufruf von CTRL+QT
  40.       erzeugt den alten Zustand).
  41.  
  42.    ---20.01.89, V1.35---
  43.    CTRL Sequenzen
  44.       In der Kommandozeile im Hauptmenue sind CTRL Sequenzen möglich:
  45.       CTRL+A : setzt nach dem nächsten Befehl ein Breakpoint, springt
  46.                an den PC und löscht danach den Breakpoint wieder. Dies ist
  47.                z.B. gut, um "DBF Dx,<label>" anzuspringen und durchlaufen
  48.                zu lassen.
  49.       CTRL+B : Break Point an PC Adresse "togglen", also setzen oder löschen
  50.       CTRL+D : wie "d pc", also ab PC disassemblieren
  51.       CTRL+Q : wie "m pc", also Memory Dump ab PC
  52.       CTRL+R : wie "jmp pc", also an PC Adresse springen
  53.       CTRL+S : wie "sc", also nächsten Befehl übergehen
  54.    par <string>
  55.       Setzt das Register D0 und A0, so, als wäre das Programm vom CLI mit
  56.       der Kommandozeile <string> aufgerufen wäre.
  57.    sp
  58.       Dieser Befehl initialisiert einen Stackpointer.
  59.    Drucker
  60.       Die Drucker Ausgabe geschieht nicht mehr in 80 Zeichen Zeilen, sondern
  61.       es werden nur soviele Zeichen ausgegeben, wie benötigt werden.
  62.    map
  63.       Der Block Allocation BitMap Editor ist fehlerfrei.
  64.    aptd <adr> <block> <file>
  65.       Dieser Befehl schreibt das File reloziert mit Adresse <adr> auf das
  66.       aktulle Laufwerk ab der BlockNummer <block>
  67.  
  68.  
  69. ZUM ASSEMBLER
  70.  
  71.    BENUTZEROBERFLÄCHE
  72.       ---20.01.90, V1.10---
  73.       Mouse Pointer
  74.          Es ist einschaltbar, daß der Mouse Pointer nach der Eingabe eines
  75.          Zeichens verschwindet, bei dem Bewegen der Mouse jedoch sofort
  76.          wieder erscheint.
  77.  
  78.    HELP
  79.       ---20.01.90, V1.10---
  80.       Neu Laden
  81.          Die Helppage kann mit F1 im Help Window neu geladen werden.
  82.  
  83.    LINKER
  84.       ---20.01.90, V1.10---
  85.       in Speicher linken
  86.          Es ist nun möglich, direkt in den Speicher zu linken.
  87.       Definitionen
  88.          Das Anzeigen aller Definitionen ist nun abschaltbar.
  89.  
  90.  
  91.    UTILITIES
  92.       Im Utilities Menue sind weiter Menuepunkte zu Alt-Keymap-Befehlen, die
  93.       jedoch noch nicht implementiert sind. Zukünftig sollen hiermit Tasten-
  94.       kombinationen mit Alt mit Zeichenketten belegt werden.
  95.  
  96.       ---20.01.90, V1.10---
  97.       Formatierung erfolgt fehlerlos.
  98.  
  99.  
  100.    ASSEMBLER
  101.       BRA.L/BRA.S
  102.          Desöfteren kommt es vor, daß in einem fertigen Programm Long
  103.          Branches benützt werden, obwohl Short Branches genauso ausreichen
  104.          würden (BRA.S). Ist im Preferences Menue die Option "report
  105.          unnecessary BRA.L" eingeschaltet, wird an jeder Stelle, wo ein
  106.          Long Branch unnötig benutzt wird, eine Warnung #109 ausgegeben.
  107.          Nun kann das Listing im Editor mit den Goto Error Funktionen ange-
  108.          passt werden.
  109.       (Ax,Dx)
  110.          Bei dieser Adressierungsart muß keine Null vor der Klammer mehr mit
  111.          angegeben (z.B. "(A0,D0)" statt "0(A0,D0)").
  112.       xxxx.W/xxxxxxxx.L
  113.          Bei der absoluten Adressierung kann hinter einer Zahl die Suffixe
  114.          ".W" und ".L" stehen, der Assembler setzt dann entweder die Word-
  115.          oder Longword Adressierung ein.
  116.  
  117.       ---20.01.90, V1.10---
  118.       Diverse Fehler
  119.          Gefundene Bugs wurden beseitigt. Eine vollständige Kompatibilität
  120.          zu SEKA und DevPac ist nicht herstellbar.
  121.          Beispiele:
  122.          So sind MOVE.W von oder zum CCR nicht zulässig (dies widerspricht
  123.          auch der Logik, da das CCR Register ein BYTE Register ist, MOVE
  124.          und MOVE.B mit dem CCR sind erlaubt). Weiterhin ist der Befehl IIF
  125.          nicht implementiert. Zahlen dürfen keine Suffixe haben, d.h.
  126.          "$64.W" ist nicht erlaubt, "$64" wird aber vom Assembler sowieso
  127.          als Short behandelt.
  128.          Die Kompatibilität wurde aber verbessert.
  129.       Lokale Labels
  130.          Es sind jetzt lokale Labels zugelassen (mit den Preferences ein-/
  131.          ausschaltbar). Ein "_" oder "." kennzeichnet ein lokales Label,
  132.          d.h. ein Label, welches nur zwischen zwei nicht-lokalen Labeln
  133.          sichtbar, d.h. ansprechbar ist.
  134.       IF..ELSE..ENDC
  135.          IF..ELSE..ENDC Konstruktionen werden korrekt verarbeitet.
  136.       BRA.S
  137.          Ein normalerweise unzulässiges BRA.S zu der nächsten Adresse wird
  138.          in ein NOP umgewandelt, es wird eine Warnung ausgegeben. Diese
  139.          Korrektur ist ausschaltbar.
  140.       BRA.L
  141.          Unnötige BRA.L, die also durch ein BRA.S ersetzt werden könnten,
  142.          was der Assembler leider nicht immer vornehmen kann (bei Forward-
  143.          Referencen), werden angezeigt (abschaltbar).
  144.       []
  145.          Eckige Klammern werden bei arithmetischen Ausdrücken nun
  146.          verarbeitet, um die SEKA-Kompatibilität zu steigern.
  147.       NOINCBIN/ONINCBIN
  148.          NOINCBIN schaltet das Einbinden von Binärdateien mit INCBIN ab,
  149.          ONINCBIN schaltet dies wieder ein.
  150.       Absoluter Code
  151.          Es besteht nun die Möglichkeit, absoluten Code zu erzeugen. ORG
  152.          im Source gibt die Adresse an, wie der Code reloziert werden soll.
  153.          Wird ein LoadFile erstellt, bedeutet das, daß die Daten binär
  154.          gespeichert werden, bei einem ObjectFile wird ein linkfähiges File
  155.          mit Hunks erstellt.
  156.       Export All/Import Undefined Labels
  157.          Es werden (abschaltbar) alle Labels exportiert (wie mit XDEF) oder
  158.          ggf. alle nicht definierten Labels importiert.
  159.       Error Wait
  160.          Nach dem Auftreten von fünf Fehlern wird nicht nur auf Tastendruck
  161.          gewartet, sondern mit "Y" kann man den Assemblierungsvorgang
  162.          abbrechen.
  163.  
  164.  
  165.    EDITOR
  166.       Es besteht ab der Version 1.03 die Möglichkeit, Seka-Source Files ein-
  167.       zulesen, und zwar so, daß die Sources automatisch konvertiert werden.
  168.       CTRL+KG öffnet den übliche Filerequester zur Auswahl des Filenames.
  169.  
  170.       ---20.01.90, V1.10---
  171.       Diverse Fehler wurden beseitigt.
  172.  
  173.  
  174.